This is just easier to avoid parallel installation problems.
gtk4-demo.xml \
gtk4-icon-browser.xml \
gtk4-widget-factory.xml \
- gtk-builder-tool.xml \
- gtk-encode-symbolic-svg.xml \
- gtk-launch.xml \
+ gtk4-builder-tool.xml \
+ gtk4-encode-symbolic-svg.xml \
+ gtk4-launch.xml \
gtk4-query-immodules.xml \
- gtk-query-settings.xml \
- gtk-update-icon-cache.xml \
+ gtk4-query-settings.xml \
+ gtk4-update-icon-cache.xml \
input-handling.xml \
migrating-2to3.xml \
migrating-3xtoy.xml \
man_MANS = \
gtk4-query-immodules.1 \
- gtk-update-icon-cache.1 \
- gtk-encode-symbolic-svg.1 \
- gtk-launch.1 \
+ gtk4-update-icon-cache.1 \
+ gtk4-encode-symbolic-svg.1 \
+ gtk4-launch.1 \
gtk4-demo.1 \
gtk4-demo-application.1 \
gtk4-widget-factory.1 \
gtk4-icon-browser.1 \
broadwayd.1 \
- gtk-builder-tool.1 \
- gtk-query-settings.1
+ gtk4-builder-tool.1 \
+ gtk4-query-settings.1
if ENABLE_MAN
+++ /dev/null
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-builder-tool">
-
-<refentryinfo>
- <title>gtk-builder-tool</title>
- <productname>GTK+</productname>
- <authorgroup>
- <author>
- <contrib>Developer</contrib>
- <firstname>Matthias</firstname>
- <surname>Clasen</surname>
- </author>
- </authorgroup>
-</refentryinfo>
-
-<refmeta>
- <refentrytitle>gtk-builder-tool</refentrytitle>
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
- <refname>gtk-builder-tool</refname>
- <refpurpose>GtkBuilder file utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-builder-tool</command>
-<arg choice="opt"><replaceable>COMMAND</replaceable></arg>
-<arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg>
-<arg choice="plain"><replaceable>FILE</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
- <command>gtk-builder-tool</command> can perform various operations
- on GtkBuilder .ui files.
-</para>
-<para>
- You should always test the modified .ui files produced by gtk-builder-tool
- before using them in production.
-</para>
-</refsect1>
-
-<refsect1><title>Commands</title>
- <para>The following commands are understood:</para>
- <variablelist>
- <varlistentry>
- <term><option>validate</option></term>
- <listitem><para>Validates the .ui file and report errors to stderr.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term><option>simplify</option></term>
- <listitem><para>Simplifies the .ui file by removing properties that
- are set to their default values and write the resulting XML to stdout.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term><option>enumerate</option></term>
- <listitem><para>Lists all the named objects that are created in the .ui file.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term><option>preview</option></term>
- <listitem><para>Preview the .ui file. This command accepts options
- to specify the ID of an object and a .css file to use.</para></listitem>
- </varlistentry>
- </variablelist>
-</refsect1>
-
-<refsect1><title>Preview Options</title>
- <para>The <option>preview</option> command accepts the following options:</para>
- <variablelist>
- <varlistentry>
- <term><option>--id=<arg choice="plain">ID</arg></option></term>
- <listitem><para>The ID of the object to preview. If not specified,
- gtk-builder-tool will choose a suitable object on its own.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--css=<arg choice="plain">FILE</arg></option></term>
- <listitem><para>Load style information from the given .css file.</para></listitem>
- </varlistentry>
- </variablelist>
-</refsect1>
-
-</refentry>
<xi:include href="gtk4-widget-factory.xml" />
<xi:include href="gtk4-icon-browser.xml" />
<xi:include href="gtk4-query-immodules.xml" />
- <xi:include href="gtk-update-icon-cache.xml" />
- <xi:include href="gtk-encode-symbolic-svg.xml" />
- <xi:include href="gtk-builder-tool.xml" />
- <xi:include href="gtk-launch.xml" />
- <xi:include href="gtk-query-settings.xml" />
+ <xi:include href="gtk4-update-icon-cache.xml" />
+ <xi:include href="gtk4-encode-symbolic-svg.xml" />
+ <xi:include href="gtk4-builder-tool.xml" />
+ <xi:include href="gtk4-launch.xml" />
+ <xi:include href="gtk4-query-settings.xml" />
<xi:include href="broadwayd.xml" />
</part>
+++ /dev/null
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-encode-symbolic-svg">
-
-<refentryinfo>
- <title>gtk-encode-symbolic-svg</title>
- <productname>GTK+</productname>
- <authorgroup>
- <author>
- <contrib>Developer</contrib>
- <firstname>Alexander</firstname>
- <surname>Larsson</surname>
- </author>
- </authorgroup>
-</refentryinfo>
-
-<refmeta>
- <refentrytitle>gtk-encode-symbolic-svg</refentrytitle>
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
- <refname>gtk-encode-symbolic-svg</refname>
- <refpurpose>Symbolic icon conversion utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-encode-symbolic-svg</command>
-<arg choice="opt">OPTION...</arg>
-<arg choice="plain"><replaceable>PATH</replaceable></arg>
-<arg choice="plain"><replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
- <command>gtk-encode-symbolic-svg</command> converts symbolic svg icons into
- specially prepared png files. GTK+ can load and recolor these pngs, just like
- original svgs, but loading them is much faster.
-</para>
-<para>
- <replaceable>PATH</replaceable> is the name of a symbolic svg file,
- <replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable> are the
- desired dimensions for the generated png file.
-</para>
-<para>
- To distinguish them from ordinary pngs, the generated files have the extension
- <filename>.symbolic.png</filename>.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-<variablelist>
- <varlistentry>
- <term>-o <replaceable>DIRECTORY</replaceable></term>
- <term>--output <replaceable>DIRECTORY</replaceable></term>
- <listitem><para>Write png files to <replaceable>DIRECTORY</replaceable>
- instead of the current working directory.</para></listitem>
- </varlistentry>
-</variablelist>
-</refsect1>
-
-</refentry>
+++ /dev/null
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-launch">
-
-<refentryinfo>
- <title>gtk-launch</title>
- <productname>GTK+</productname>
- <authorgroup>
- <author>
- <contrib>Developer</contrib>
- <firstname>Tomáš</firstname>
- <surname>Bžatek</surname>
- <email>tbzatek@redhat.com</email>
- </author>
- </authorgroup>
-</refentryinfo>
-
-<refmeta>
- <refentrytitle>gtk-launch</refentrytitle>
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
- <refname>gtk-launch</refname>
- <refpurpose>Launch an application</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-launch</command>
-<arg choice="opt" rep="repeat">OPTION</arg>
-<arg choice="plain">APPLICATION</arg>
-<arg choice="opt" rep="repeat">URI</arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk-launch</command> launches an application using the given name.
-The application is started with proper startup notification on a default
-display, unless specified otherwise.
-</para>
-<para>
-<command>gtk-launch</command> takes at least one argument, the name of
-the application to launch. The name should match application desktop file name,
-as residing in /usr/share/application, with or without the '.desktop' suffix.
-</para>
-<para>
-If called with more than one argument, the rest of them besides the application
-name are considered URI locations and are passed as arguments to the launched
-application.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
- <para>The following options are understood:</para>
- <variablelist>
- <varlistentry>
- <term><option>-?</option>, <option>--help</option></term>
- <listitem><para>Prints a short help text and exits.</para></listitem>
- </varlistentry>
- </variablelist>
- <variablelist>
- <varlistentry>
- <term><option>--version</option></term>
- <listitem><para>Prints the program version and exits.</para></listitem>
- </varlistentry>
- </variablelist>
-</refsect1>
-
-</refentry>
+++ /dev/null
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-query-settings">
-
-<refentryinfo>
- <title>gtk-query-settings</title>
- <productname>GTK+</productname>
- <authorgroup>
- <author>
- <contrib>Developer</contrib>
- <firstname>Timm</firstname>
- <surname>Bäder</surname>
- </author>
- </authorgroup>
-</refentryinfo>
-
-<refmeta>
- <refentrytitle>gtk-query-settings</refentrytitle>
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
- <refname>gtk-query-settings</refname>
- <refpurpose>Utility to print name and value of all GtkSettings properties</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-query-settings</command>
-<arg choice="opt"><replaceable>PATTERN</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
- <command>gtk-query-settings</command> prints both name and value of all properties
- available in the GtkSettings class. Optionally, you can filter which properties
- to list by specifying a PATTERN.
-</para>
-</refsect1>
-
-</refentry>
+++ /dev/null
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-update-icon-cache">
-
-<refentryinfo>
- <title>gtk-update-icon-cache</title>
- <productname>GTK+</productname>
- <authorgroup>
- <author>
- <contrib>Developer</contrib>
- <firstname>Matthias</firstname>
- <surname>Clasen</surname>
- </author>
- </authorgroup>
-</refentryinfo>
-
-<refmeta>
- <refentrytitle>gtk-update-icon-cache</refentrytitle>
- <manvolnum>1</manvolnum>
- <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
- <refname>gtk-update-icon-cache</refname>
- <refpurpose>Icon theme caching utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-update-icon-cache</command>
-<arg choice="opt">--force</arg>
-<arg choice="opt">--ignore-theme-index</arg>
-<group>
- <arg choice="plain">--index-only</arg>
- <arg choice="plain">--include-image-data</arg>
-</group>
-<arg choice="opt">--source <arg choice="plain"><replaceable>NAME</replaceable></arg></arg>
-<arg choice="opt">--quiet</arg>
-<arg choice="opt">--validate</arg>
-<arg choice="plain"><replaceable>PATH</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
- <command>gtk-update-icon-cache</command> creates mmapable cache
- files for icon themes.
-</para>
-<para>
- It expects to be given the <replaceable>PATH</replaceable> to a icon theme
- directory containing an <filename>index.theme</filename>, e.g.
- <filename>/usr/share/icons/hicolor</filename>, and writes a
- <filename>icon-theme.cache</filename> containing cached information about
- the icons in the directory tree below the given directory.
-</para>
-<para>
- GTK+ can use the cache files created by <command>gtk-update-icon-cache</command>
- to avoid a lot of system call and disk seek overhead when the application
- starts. Since the format of the cache files allows them to be mmaped
- shared between multiple applications, the overall memory consumption is
- reduced as well.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-<variablelist>
- <varlistentry>
- <term>--force</term>
- <term>-f</term>
- <listitem><para>Overwrite an existing cache file even if it appears to be
- uptodate.</para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--ignore-theme-index</term>
- <term>-t</term>
- <listitem><para>Don't check for the existence of <filename>index.theme</filename>
- in the icon theme directory. Without this option, <command>gtk-update-icon-cache</command>
- refuses to create an icon cache in a directory which does not appear to
- be the toplevel directory of an icon theme.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--index-only</term>
- <term>-i</term>
- <listitem><para>Don't include image data in the cache.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--include-image-data</term>
- <listitem><para>Include image data in the cache.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--source</term>
- <term>-c</term>
- <listitem><para>Output a C header file declaring a constant
- <replaceable>NAME</replaceable> with the contents of the icon
- cache.</para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--quiet</term>
- <term>-q</term>
- <listitem><para>Turn off verbose output.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--validate</term>
- <term>-v</term>
- <listitem><para>Validate existing icon cache.
- </para></listitem>
- </varlistentry>
-</variablelist>
-</refsect1>
-
-</refentry>
--- /dev/null
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-builder-tool">
+
+<refentryinfo>
+ <title>gtk4-builder-tool</title>
+ <productname>GTK+</productname>
+ <authorgroup>
+ <author>
+ <contrib>Developer</contrib>
+ <firstname>Matthias</firstname>
+ <surname>Clasen</surname>
+ </author>
+ </authorgroup>
+</refentryinfo>
+
+<refmeta>
+ <refentrytitle>gtk4-builder-tool</refentrytitle>
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+ <refname>gtk4-builder-tool</refname>
+ <refpurpose>GtkBuilder file utility</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-builder-tool</command>
+<arg choice="opt"><replaceable>COMMAND</replaceable></arg>
+<arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg>
+<arg choice="plain"><replaceable>FILE</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+ <command>gtk4-builder-tool</command> can perform various operations
+ on GtkBuilder .ui files.
+</para>
+<para>
+ You should always test the modified .ui files produced by gtk4-builder-tool
+ before using them in production.
+</para>
+</refsect1>
+
+<refsect1><title>Commands</title>
+ <para>The following commands are understood:</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>validate</option></term>
+ <listitem><para>Validates the .ui file and report errors to stderr.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>simplify</option></term>
+ <listitem><para>Simplifies the .ui file by removing properties that
+ are set to their default values and write the resulting XML to stdout.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>enumerate</option></term>
+ <listitem><para>Lists all the named objects that are created in the .ui file.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>preview</option></term>
+ <listitem><para>Preview the .ui file. This command accepts options
+ to specify the ID of an object and a .css file to use.</para></listitem>
+ </varlistentry>
+ </variablelist>
+</refsect1>
+
+<refsect1><title>Preview Options</title>
+ <para>The <option>preview</option> command accepts the following options:</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>--id=<arg choice="plain">ID</arg></option></term>
+ <listitem><para>The ID of the object to preview. If not specified,
+ gtk4-builder-tool will choose a suitable object on its own.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--css=<arg choice="plain">FILE</arg></option></term>
+ <listitem><para>Load style information from the given .css file.</para></listitem>
+ </varlistentry>
+ </variablelist>
+</refsect1>
+
+</refentry>
--- /dev/null
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-encode-symbolic-svg">
+
+<refentryinfo>
+ <title>gtk4-encode-symbolic-svg</title>
+ <productname>GTK+</productname>
+ <authorgroup>
+ <author>
+ <contrib>Developer</contrib>
+ <firstname>Alexander</firstname>
+ <surname>Larsson</surname>
+ </author>
+ </authorgroup>
+</refentryinfo>
+
+<refmeta>
+ <refentrytitle>gtk4-encode-symbolic-svg</refentrytitle>
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+ <refname>gtk4-encode-symbolic-svg</refname>
+ <refpurpose>Symbolic icon conversion utility</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-encode-symbolic-svg</command>
+<arg choice="opt">OPTION...</arg>
+<arg choice="plain"><replaceable>PATH</replaceable></arg>
+<arg choice="plain"><replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+ <command>gtk4-encode-symbolic-svg</command> converts symbolic svg icons into
+ specially prepared png files. GTK+ can load and recolor these pngs, just like
+ original svgs, but loading them is much faster.
+</para>
+<para>
+ <replaceable>PATH</replaceable> is the name of a symbolic svg file,
+ <replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable> are the
+ desired dimensions for the generated png file.
+</para>
+<para>
+ To distinguish them from ordinary pngs, the generated files have the extension
+ <filename>.symbolic.png</filename>.
+</para>
+</refsect1>
+
+<refsect1><title>Options</title>
+<variablelist>
+ <varlistentry>
+ <term>-o <replaceable>DIRECTORY</replaceable></term>
+ <term>--output <replaceable>DIRECTORY</replaceable></term>
+ <listitem><para>Write png files to <replaceable>DIRECTORY</replaceable>
+ instead of the current working directory.</para></listitem>
+ </varlistentry>
+</variablelist>
+</refsect1>
+
+</refentry>
--- /dev/null
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-launch">
+
+<refentryinfo>
+ <title>gtk4-launch</title>
+ <productname>GTK+</productname>
+ <authorgroup>
+ <author>
+ <contrib>Developer</contrib>
+ <firstname>Tomáš</firstname>
+ <surname>Bžatek</surname>
+ <email>tbzatek@redhat.com</email>
+ </author>
+ </authorgroup>
+</refentryinfo>
+
+<refmeta>
+ <refentrytitle>gtk4-launch</refentrytitle>
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+ <refname>gtk4-launch</refname>
+ <refpurpose>Launch an application</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-launch</command>
+<arg choice="opt" rep="repeat">OPTION</arg>
+<arg choice="plain">APPLICATION</arg>
+<arg choice="opt" rep="repeat">URI</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+<command>gtk4-launch</command> launches an application using the given name.
+The application is started with proper startup notification on a default
+display, unless specified otherwise.
+</para>
+<para>
+<command>gtk4-launch</command> takes at least one argument, the name of
+the application to launch. The name should match application desktop file name,
+as residing in /usr/share/application, with or without the '.desktop' suffix.
+</para>
+<para>
+If called with more than one argument, the rest of them besides the application
+name are considered URI locations and are passed as arguments to the launched
+application.
+</para>
+</refsect1>
+
+<refsect1><title>Options</title>
+ <para>The following options are understood:</para>
+ <variablelist>
+ <varlistentry>
+ <term><option>-?</option>, <option>--help</option></term>
+ <listitem><para>Prints a short help text and exits.</para></listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term><option>--version</option></term>
+ <listitem><para>Prints the program version and exits.</para></listitem>
+ </varlistentry>
+ </variablelist>
+</refsect1>
+
+</refentry>
--- /dev/null
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-query-settings">
+
+<refentryinfo>
+ <title>gtk4-query-settings</title>
+ <productname>GTK+</productname>
+ <authorgroup>
+ <author>
+ <contrib>Developer</contrib>
+ <firstname>Timm</firstname>
+ <surname>Bäder</surname>
+ </author>
+ </authorgroup>
+</refentryinfo>
+
+<refmeta>
+ <refentrytitle>gtk4-query-settings</refentrytitle>
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+ <refname>gtk4-query-settings</refname>
+ <refpurpose>Utility to print name and value of all GtkSettings properties</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-query-settings</command>
+<arg choice="opt"><replaceable>PATTERN</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+ <command>gtk4-query-settings</command> prints both name and value of all properties
+ available in the GtkSettings class. Optionally, you can filter which properties
+ to list by specifying a PATTERN.
+</para>
+</refsect1>
+
+</refentry>
--- /dev/null
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-update-icon-cache">
+
+<refentryinfo>
+ <title>gtk4-update-icon-cache</title>
+ <productname>GTK+</productname>
+ <authorgroup>
+ <author>
+ <contrib>Developer</contrib>
+ <firstname>Matthias</firstname>
+ <surname>Clasen</surname>
+ </author>
+ </authorgroup>
+</refentryinfo>
+
+<refmeta>
+ <refentrytitle>gtk4-update-icon-cache</refentrytitle>
+ <manvolnum>1</manvolnum>
+ <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+ <refname>gtk4-update-icon-cache</refname>
+ <refpurpose>Icon theme caching utility</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-update-icon-cache</command>
+<arg choice="opt">--force</arg>
+<arg choice="opt">--ignore-theme-index</arg>
+<group>
+ <arg choice="plain">--index-only</arg>
+ <arg choice="plain">--include-image-data</arg>
+</group>
+<arg choice="opt">--source <arg choice="plain"><replaceable>NAME</replaceable></arg></arg>
+<arg choice="opt">--quiet</arg>
+<arg choice="opt">--validate</arg>
+<arg choice="plain"><replaceable>PATH</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+ <command>gtk4-update-icon-cache</command> creates mmapable cache
+ files for icon themes.
+</para>
+<para>
+ It expects to be given the <replaceable>PATH</replaceable> to a icon theme
+ directory containing an <filename>index.theme</filename>, e.g.
+ <filename>/usr/share/icons/hicolor</filename>, and writes a
+ <filename>icon-theme.cache</filename> containing cached information about
+ the icons in the directory tree below the given directory.
+</para>
+<para>
+ GTK+ can use the cache files created by <command>gtk4-update-icon-cache</command>
+ to avoid a lot of system call and disk seek overhead when the application
+ starts. Since the format of the cache files allows them to be mmaped
+ shared between multiple applications, the overall memory consumption is
+ reduced as well.
+</para>
+</refsect1>
+
+<refsect1><title>Options</title>
+<variablelist>
+ <varlistentry>
+ <term>--force</term>
+ <term>-f</term>
+ <listitem><para>Overwrite an existing cache file even if it appears to be
+ uptodate.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>--ignore-theme-index</term>
+ <term>-t</term>
+ <listitem><para>Don't check for the existence of <filename>index.theme</filename>
+ in the icon theme directory. Without this option, <command>gtk4-update-icon-cache</command>
+ refuses to create an icon cache in a directory which does not appear to
+ be the toplevel directory of an icon theme.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>--index-only</term>
+ <term>-i</term>
+ <listitem><para>Don't include image data in the cache.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>--include-image-data</term>
+ <listitem><para>Include image data in the cache.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>--source</term>
+ <term>-c</term>
+ <listitem><para>Output a C header file declaring a constant
+ <replaceable>NAME</replaceable> with the contents of the icon
+ cache.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>--quiet</term>
+ <term>-q</term>
+ <listitem><para>Turn off verbose output.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>--validate</term>
+ <term>-v</term>
+ <listitem><para>Validate existing icon cache.
+ </para></listitem>
+ </varlistentry>
+</variablelist>
+</refsect1>
+
+</refentry>
#
bin_PROGRAMS = \
gtk4-query-immodules \
- gtk-update-icon-cache \
- gtk-encode-symbolic-svg \
- gtk-builder-tool \
- gtk-query-settings \
- gtk-launch
+ gtk4-update-icon-cache \
+ gtk4-encode-symbolic-svg \
+ gtk4-builder-tool \
+ gtk4-query-settings \
+ gtk4-launch
gtk4_query_immodules_SOURCES = queryimmodules.c gtkutils.c
gtk4_query_immodules_LDADD = \
$(GMODULE_LIBS) \
$(GTK_DEP_LIBS)
-gtk_update_icon_cache_SOURCES = updateiconcache.c
-gtk_update_icon_cache_LDADD = $(GDK_PIXBUF_LIBS)
+gtk4_update_icon_cache_SOURCES = updateiconcache.c
+gtk4_update_icon_cache_LDADD = $(GDK_PIXBUF_LIBS)
-gtk_encode_symbolic_svg_SOURCES = encodesymbolic.c
-gtk_encode_symbolic_svg_LDADD = \
+gtk4_encode_symbolic_svg_SOURCES = encodesymbolic.c
+gtk4_encode_symbolic_svg_LDADD = \
$(GDK_PIXBUF_LIBS) \
$(top_builddir)/gdk/libgdk-4.la \
$(top_builddir)/gsk/libgsk-4.la \
$(GTK_DEP_LIBS)
-gtk_builder_tool_SOURCES = gtk-builder-tool.c
-gtk_builder_tool_LDADD = \
+gtk4_builder_tool_SOURCES = gtk-builder-tool.c
+gtk4_builder_tool_LDADD = \
libgtk-4.la \
$(top_builddir)/gdk/libgdk-4.la \
$(top_builddir)/gsk/libgsk-4.la \
$(GTK_DEP_LIBS)
-gtk_query_settings_SOURCES = gtk-query-settings.c
-gtk_query_settings_LDADD= \
+gtk4_query_settings_SOURCES = gtk-query-settings.c
+gtk4_query_settings_LDADD= \
libgtk-4.la \
$(top_builddir)/gdk/libgdk-4.la \
$(top_builddir)/gsk/libgsk-4.la \
$(GTK_DEP_LIBS)
-gtk_launch_SOURCES = gtk-launch.c
-gtk_launch_LDADD = \
+gtk4_launch_SOURCES = gtk-launch.c
+gtk4_launch_LDADD = \
libgtk-4.la \
$(top_builddir)/gdk/libgdk-4.la \
$(top_builddir)/gsk/libgsk-4.la \